Inside Macintosh: Mac OS 8 Toolbox Reference /

Chapter 1 - Appearance Manager Reference / Appearance Manager Functions

Drawing Appearance-Compliant Controls /

DrawThemeSeparator

NEW WITH THE APPEARANCE MANAGER

Draws a separator line consistent with the current theme.

pascal OSStatus DrawThemeSeparator (
                     const Rect *inRect,
                     ThemeDrawState inState);

inRect

On input, a pointer to a rectangle.

inState

A value specifying the state in which the separator line is to be drawn; see "Appearance-Compliant Draw State Constants". The separator line can only be drawn as active or inactive; passing kThemeStatePressed will result in an error being returned.

function result

A result code; see "Result Codes".

DISCUSSION

The DrawThemeSeparator function draws a separator line inside the rectangle passed in, which is a maximum of 2 pixels thick. The orientation of the rectangle determines where the separator line is drawn. If the rectangle is wider than it is tall, the separator line is horizontal; otherwise it is vertical.

SEE ALSO

"Control Guidelines" in Mac OS 8 Human Interface Guidelines.